Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Advanced Job Object Functions

GXCopyJob

You can use the GXCopyJob function to copy job object data from one job object to another.

gxJob GXCopyJob (gxJob srcJob, gxJob dstJob);

srcJob

A reference to the job object to copy.

dstJob

A reference to the job object in which to receive the copied data.

function result

A reference to a job object.

DESCRIPTION

The GXCopyJob function makes a copy of the job object specified by the srcJob parameter and stores a reference to it in the dstJob parameter. If you set the dstJob parameter to nil, QuickDraw GX allocates and returns a new job object with the properties of the srcJob parameter.

For example, you can use this function to copy a job object for use with another document. All information from the source job object is copied into the destination job object, including references to the output and formatting printers, formats, and paper types.

QuickDraw GX allocates appropriate space if the job object that you are copying (the source job object) contains more objects, such as formats, than the job object that you are copying into (the destination job object).

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

For an example that uses the GXCopyJob function, see "Copying Job Object Information" on page 4-25.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help